Skip to content

reduce per-loop context load in harness workflows - #10

Merged
devRonPark merged 3 commits into
mainfrom
claude/harness-context-audit-891yva
Jul 9, 2026
Merged

reduce per-loop context load in harness workflows#10
devRonPark merged 3 commits into
mainfrom
claude/harness-context-audit-891yva

Conversation

@devRonPark

Copy link
Copy Markdown
Owner

harness-work 루프가 매 실행마다 규칙/상태 문서 약 94KB를 전체 로드하던
구조를 선택적 로드로 변경한다. 절차의 게이트·TDD·검증·리뷰 순서와
스크립트 동작은 바꾸지 않는다.

  • Task 선택: tasks/index.json 전체 Read 대신 report_tasks.py 요약 +
    grep -A12 단일 Task 블록 읽기
  • Plans.md: 에이전트 읽기 목록 전부에서 제거 (사람용 생성물, 쓰기 전용)
  • 규칙 문서(AGENTS/CLAUDE/quality-gates): 세션 내 재독 금지 (리뷰 단계 포함)
  • task-decomposer.md: 1차 게이트 통과 시 로드 생략, 미달 의심 시만 전체 읽기
  • LESSONS.md: 최근 5개만 읽기 + 최대 8개 유지 rewrite 규칙 (append 누수 차단)
  • Task 디렉토리 템플릿 복사: 6종 -> 3종 (STATE/LOG/RUN_REPORT)
  • README/AGENTS/CONTEXT_INDEX(루트+skeleton) 재개 순서를 동일 원칙으로 동기화

검증: validate_tasks.py PASS, sync_plans.py --check PASS, pytest 18 passed.
evidence: .harness/tasks/context-budget-patch/RUN_REPORT.md

Co-Authored-By: Claude Fable 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01RDmiM8WUBqx9Xc8F4mqgaL

claude added 3 commits July 9, 2026 09:39
harness-work 루프가 매 실행마다 규칙/상태 문서 약 94KB를 전체 로드하던
구조를 선택적 로드로 변경한다. 절차의 게이트·TDD·검증·리뷰 순서와
스크립트 동작은 바꾸지 않는다.

- Task 선택: tasks/index.json 전체 Read 대신 report_tasks.py 요약 +
  grep -A12 단일 Task 블록 읽기
- Plans.md: 에이전트 읽기 목록 전부에서 제거 (사람용 생성물, 쓰기 전용)
- 규칙 문서(AGENTS/CLAUDE/quality-gates): 세션 내 재독 금지 (리뷰 단계 포함)
- task-decomposer.md: 1차 게이트 통과 시 로드 생략, 미달 의심 시만 전체 읽기
- LESSONS.md: 최근 5개만 읽기 + 최대 8개 유지 rewrite 규칙 (append 누수 차단)
- Task 디렉토리 템플릿 복사: 6종 -> 3종 (STATE/LOG/RUN_REPORT)
- README/AGENTS/CONTEXT_INDEX(루트+skeleton) 재개 순서를 동일 원칙으로 동기화

검증: validate_tasks.py PASS, sync_plans.py --check PASS, pytest 18 passed.
evidence: .harness/tasks/context-budget-patch/RUN_REPORT.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RDmiM8WUBqx9Xc8F4mqgaL
.claude/commands/에 harness-{plan,work,review,progress,sync,yagni-trimmer}
wrapper를 추가한다. 절차 원본은 기존 .agents/skills/*/SKILL.md이며,
git 헬퍼 커맨드(branch-checkout 등)와 같은 thin wrapper 패턴을 따른다.
plugin 없이도 /harness-* 커맨드가 동작하고, init.sh가 .claude/commands/
전체를 복사하므로 새 프로젝트에도 자동 전파된다.

읽기 전용 커맨드(review/progress/sync)는 allowed-tools를 스크립트·조회
명령으로 제한했고, work/plan은 구현 작업 특성상 세션 권한을 따른다.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RDmiM8WUBqx9Xc8F4mqgaL
harness-work 구현 전 반드시 대상 Task 전용 브랜치(task/{task-id}-{short-slug})로
이동하는 룰을 추가한다. main/master 직접 구현을 금지하고, 브랜치 생성·전환은
기존 branch-checkout, main 위 작업 구출은 rescue-from-main 절차를 재사용한다.
GitHub 연동([github].enabled) 여부와 무관하게 적용한다.

- .agents/skills/harness-work/SKILL.md: step 5에 브랜치 게이트, 완료 기준에
  "Task 브랜치 커밋" 추가
- .claude/commands/harness-work.md: wrapper에 동일 룰 반영
- CLAUDE.md 구현 규칙: 무조건 룰로 명문화
- BLUEPRINT.md: Implementation 게이트 목록에 4번으로 삽입

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RDmiM8WUBqx9Xc8F4mqgaL
@devRonPark
devRonPark merged commit 98d6781 into main Jul 9, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants